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LICENSE AGREEMENT 


FROBCO 

643 Mission Street 

Santa Cruz, California 95260 
Telephone: 408-429-1551 








Zip Code 

Telephone Number 

PROGRAM PRODUCT: 

1. Title of Software Disk 

Release Version Number Disk Serial Number 


2. Title of Software Disk 





Release Version Number Disk Serial Number 


FROB-COLECO Hardware Serial Number 

















LICENSE 


FROBCO grants and Licensee accepts perpetual nonexclusive 
license to use the FROB-COLECO Development Software programs 
listed above, together with the modifications and additions 
as furnished by FROBCO, subject to the "Standard Terms and 
Conditions for End User Software License Agri "attached 
hereto and incorporated herein by reference. 
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Chapter 1. INTRODUCING THE FROB 
1.1 Legend of the Frob 


Mythically, the Frob is an unusually intelligent creature, 
with some very special magical gifts. For example, the Frob has 
the ability to assume the identity of other creatures, 
duplicating their very nature to the smallest detail. like a 
chameleon, the Frob can instantly change form, becoming an amoeba 
one instant, an extraterrestrial the next. 


This, of course, brings up the question of the true identity 
of the Frob. If you could be anyone at any time, who would you 
be? The Frob often wondered about this and would ask all the 
creatures it’ duplicated what they would be if they could be 
anything. S/he* got every answer imaginable and tried them all.. 


But the Frob found most fantasies got to be pretty boring 
after awhile, and kept changing hir* form. Not stopping with 
- piological life forms and fantasies, s/he tried being fire, 
clouds, electricity, sounds, quartz crystals, galaxies, space and 
time, learning all kinds of things about everything. 


And in the course of milti-dimensional events, s/he evolved 
a special love of humans, as they are creatures that often 
wondered about things too. The Frob learned much fram the humans 
s/he became, assimilating many new things and. experiences. 


The Frob most enjoyed commmicating with human children, 
truly curious creatures who easily accepted hir magical 
abilities. Through the children s/he learned about the nature of 
real dreams, and was soon able to cammnicate with adult humans 
during their sleeping hours. 


It was in this way that s/he first contacted a human 
who was extremely knowledgeable of camputers during his waking 
hours. S/he was very curious about this new human enterprise, 
learning all about camputers and artificial intelligence from his 
sleeping biocomputer. 


To the Frob's amazement and never-ending curiosity, s/he 
realized that both the camputers and their creators, the 
biocoamputers, were beginning to develop the ability to become and 
do many different things, just like hir. 


The only problem was that, as. curious as the humans were, 
they did not quite grok the possibilities and freedams of being 
many many things. So s/he decided to help out a little by giving 
ideas to computer-oriented people in their dreams. Ideas that 
stimulated more interesting, multi-dimensional uses for 
the new human tool. Uses that would stimulate an increased sense 
of curiosity about what might really be going on in this 
universe. 


* s/he and hir are the preferred pronouns of the Frob. 
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You see, despite all the knowledge and experience gathered 
by the Frob, s/he did not have the slightest clue of why all this 
was happening. S/he shared water with creatures who believed 
that you'd learn a lot by not asking why things existed. S/he 
traveled faster than light, going back in time to explore the 
beginnings of the physical universe. To get a bigger 
perspective, s/he expanded hir physical body so that every atom 
was a star, light years apart from the other. S/he even became 
mortal, to see what that was like. 


But none of these things satisfied hir natural curiosity. 
And humans were the only other ones, so far, who shared this 
curious natural wonder with hir, exploring the same things, ™mly 
from a more basic, less flexible form. 


In a brilliant insight that came from hir new ability to 
dream, the Frob saw that collaboration of Silicon Intelligence 
with Biological Intelligence would give the curious humans more 
freedom to explore possibilities. All s/he had to do was 
translate this insight into a form understood by hir new human 
friends. For more than anything else, s/he wants campany with 
others who are as versatile and curious as s/he is. 


The following manual is the first part of hir translation, 
as filtered through the minds of humans. 
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1.2 Mission of the Frob 


The Frob's mission begins with giving curious entrepreneurs 
and programmers, both rich and poor, new and used, an opportunity 
to create educational, business and gaming software cartridges 
for both specialized applications and the mass consumer 
marketplace. 


The Frob-Coleco system is a professional software 
development environment for the ColecoVision. The ColecoVision, 
known for its ability to generate arcade quality, colorful, 
animated images and sophisticated sound effects, provides an 
inexpensive environment for creating dynamic software. With the 
Frob-Coleco system, you will be able to program your own 
ColecoVision cartridges, also compatible with the Adam Camputer. 


Until the Frob, creating arcade-quality machine cartridges 
required an investment of tens of thousands of dollars. Unlike 
the independent goldminers and adventurous oilmen of the past, 
individuals and small development companies can now have many of 
the same advantages as the big companies. . 


The Frob-Coleco system, in combination with a commercially 
available 2764 PROM programmer (not supplied with the Frob-Coleco 
system), allows a single individual to create software products 
along with ColecoVision and Adam cartridge prototypes. 


With the advent of electronic distribution of software, 
there is a continued market for Coleco software. . Within a couple 
weeks of the time it takes to think of and design a software 
product, merchandise can be delivered to the customer. There is 
no longer any need for maintaining an inventory of your software 
products, as hardware protected cartridge copies can be made on 
the spot, as orders are received. With low overhead (basically 
programmable cases and instructions), a very competitive price 
and a quick return for your software can be achieved. 


The Frob-Coleco system is a cambination of hardware, 
software, and user support. The Frob hardware includes the Frob 
Interface Unit, the Apple card, cable and Frob-Coleco EPROM 
adapter. The software includes an Apple Development package and 
the Lazer Monitor system. User support includes’ the 
documentation and technical guidance available by telephone fram 
Frobco. 


"May the Frob be With You" 
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1.3 Installing the Frob 


The complete Frob-Coleco system requires a 64K Apple 
Computer with disk drive and a ColecoVision to function. 


The components you receive from FROBCO are: 


1) Frob-Apple Card - a PC board that plugs into slot #2 of the 
Apple. 


2) Frob Interface Unit - a PC board ina case that plugs into 
the Colecovision Expansion slot. 


3) Frob-Coleco EPROM Cartridge Adapter - a small PC board that 
plugs into the cartridge slot of the Colecovision. 


4) A cable that connects the Frob-Apple Card with the Frob 
Interface Unit. 


5) An Applesoft Basic disk entitled "Apple Development System - 
Coleco Loader." 


6) A CP/M disk entitled "Lazer 2-88 Monitor." 
7) The Frob-Coleco User's Manual. 
The components you need besides the Frob are: 
1) A 64K Apple II, II+ or Ile microcomputer. 
2) An Apple disk drive with controller card. 
3) An Apple monitor. 
4) A ColecoVision video arcade system. 
5) A color TV for the ColecoVision display. 


6) A Microsoft Z-8@ Softcard (or hardware equivalent) to mn 
LZRMON program only. 


To get the Frob-Coleco System working: 
1) Get the Apple working normally (read Apple Reference Manual). 


2) Get the ColecoVision working normally (see ColecoVision 
Instruction Booklet). 


3) Plug the Frob-Apple card into Slot #2 of the Apple computer, 
with the cable inserted in the card so that cable comes out 
the back of the Apple. 


4) Plug the Frob Interface Unit into the expansion bus of the 
ColecoVision console. 
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5) When used, the Frob-Coleco EPROM cartridge adapter plugs into 
the ColecoVision game cartridge slot. It has four sockets 
which will hold four 2764 (8K) EPROMS. This adapter and 
"burned" EPROMS (a maximum of 32K) is your demo cartridge. 
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Chapter 2. HE DEVELOPMENT SYSTEM - A FROB'S EYE VIEW 


2-1 THE APPLE DEVELOPMENT SYSTEM 


2.1.1 Introduction 

With the Apple Development software, you create your own or 
modify ColecoVision programs on the Apple, and then test them on 
either the ColecoVision or the Frob Interface Unit. The Coleco 


Loader program, discussed below, will allow you to transfer data 
to and fram the ColecoVision, Apple and the Frob Interface Unit. 


2.1.2 Required Equipment 

Besides the package fram Frobco, the Frob-Coleco development » 
system requires a 64K Apple II, II+ or Ile camputer, with DOS 
3.3, Applesoft Basic, anda ColecoVision arcade unit. A 2764 
PROM programmer machine is also necessary, if you wish to 
duplicate your program onto blank Frob-Coleco cartridge adapters. 
2.1.3 Menu Functions 

After the Frob-Coleco development system is hooked up,. 
insert the Apple Development System — Coleco Loader Disk into the 
Apple Drive 1 (one) and boot it up. You will see a menu: 

PLEASE CHOOSE FUNCTION BY NUMBER: | 

1 — LOAD FROB MEMORY FROM APPLE DISK 

2 -- MOVE FROB MEMORY TO APPLE DISK 

3 — MOVE FROM CARTRIDGE TO APPLE DISK 

4 —— MOVE FROM CARTRIDGE TO FROB MEMORY 

5 — DISPLAY FROB CONTROL PARAMETERS 

6 -- SET FROB CONTROL PARAMETERS 

7 — RESET AND RUN PROG IN FROB MEMORY 

8 -- RESET AND RUN PROG IN COLECO ROM 


9 — EXIT 
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Let's take a look at each of these menu selections: 
1 — LOAD FROB MEMORY FROM APPLE DISK 

This option loads a binary program from the Apple disk to 
the Frob-Coleco development system. After choosing this option, 
you will be asked which slot the Frob-Apple Interface Card is 
Plugged into: 

INTERFACE SLOT NUMBER? (1-7) 


Any slot will work, though for other Frob software (i.e. the 
Lazer Z-88 Monitor), the Apple card must be in slot 2. 


Type in the slot number you have plugged the board into 
(usually slot 2) and press the Return key. 


The next message you see is: 
FILES MUST BE &K BYTES OR LESS 
HOW MANY 8K BLOCKS? (1-4) 


The cartridge address space in the ColecoVision runs from 
Q8000H to OFFFFH. This means that there is room for a 32K 
program, or four 8K blocks of memory. Let's say you have a 
binary program named 'FOOBAR' that is 24K bytes long. To store 
this program you need 3 of the 4 available 8K memory blocks. 
These would be arranged on your disk as: 


FOOBAR.B4 
FOOBAR.B5 
FOOBAR .B6 


So, in the case of our 'FOOBAR' example, the answer to the 
last question is '3'. 


The next question is: 

INPUT THE BASE FILE NAME 

Here you type in the file name without the extension (.B?). 
In our 'FOOBAR' example you would type in 'FOOBAR', followed by a 
Return key. 

The next question is: 

INPUT THE STARTING BLOCK NUMBER (4-7) 


In the case of FOOBAR you would type in '4' since FOOBAR.B4 
is the first 8K file to be loaded. 


The COLECO LOADER then loads in the file and simultaneously 
prints out the file name and the checksum on your CRI (the 
checksum is used for debugging purposes). In our example, you 
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will see on the screen before you: 


LOADING FOOBAR.B4 CHECKSUM=@D@8FE 
LOADING FOOBAR.B5 CHECKSUM=09B555 
LOADING FOOBAR.B6 CHECKSUM=055555 


After loading the file, the COLECO LOADER program redisplays 
the option menu and waits for your next command. 


The next option on the menu is: 
2 — MOVE FROB MEMORY TO APPLE DISK 

This command transfers the binary program residing in the 
Frob-Coleco development system onto the Apple disk. Type in a 
'2', followed by a Return key to select this option. You will 
then be asked a series of questions: 


BASE FILENAME — 


Type in the name of your program, without an extension. Like 
'FOOBAR', without the '.B4' extension, for example. 


Next you are asked to type in the starting block number. 

INPUT STARTING BLOCK NUMBER (4-7) 

As with option '1', the block number corresponds to an 8K 
block of ColecoVision development system memory. These are 


interpreted and represent the following locations in ColecoVision 
memory: 


4 = 98000H-G9FFFH 
5 = GAQOOH-GBFFFH 
6 = OCOGOO-ODFFFH 
7 = QEQQO0-OFFFFH 


If you want to save the whole binary program from the 
beginning, type ina ‘a’. 


Eight blocks of 8K memory equal 64K. The Frob user program 
memory resides in the upper 32K of the ColecoVision, or blocks 
4,5,6, and 7 of memory. Hence the starting blocks begin at 4 
(Blocks start at zero in the ColecoVision and continue up to 
seven). Blocks @-3 contains the Coleco Monitor, 1K of scratchpad 
RAM, and unused addresses. See Appendix A, section A.1 regarding 
further information on the ColecoVision memory map. 


After selecting the starting block number, type in the 
number of contiguous 8K blocks to save: 


INPUT THE NUMBER OF 8K BLOCKS (1-4) 


If all of memory is to be saved, then type in 4. 
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The COLECO LOADER then saves the file m the Apple aiak, 
You will see messages to this effect on your CRT: 
SAVING FILE FOOBAR.B4 CHECKSUM=01FEQOO 
SAVING FILE FOOBAR.B5 CHECKSUM=01FEQ@9 
SAVING FILE FOOBAR.B6 CHECKSUM=41FEG@GO 


3 —— MOVE FROM CARTRIDGE TO APPLE DISK 


This option allows you to read any 8K block of memory from 
the ColecoVision and save it on the Apple disk. You select this 
option by typing a '3', followed by a Return key. You are then 
asked which slot the Apple card of development system is plugged 
into: 


INTERFACE SLOT NUMBER? (1-7) 


in the slot number the Frob-Apple Interface card is 
Plugged into, followed by a Return key. You will then be asked 
for a file name: 


BASE FILENAME -— 


Choose and type in a file name (i.e. FOOBAR). Now you will 
be asked where (the location in Colecovison memory) to save fran: 


INPUT STARTING BLOCK NUMBER (0-7) 


You have the ability to save 8K blocks of memory fran 
anywhere in the ColecoVision address space. Block @ is the 
ColecoVision monitor area (See Appendix A for a description of 
the ColecoVision monitor). The cartridge area resides in blocks 
4~7. If you wish to read the programs on the cartridge, type in 
a 4 in response to the above INPUT command. 


The next question asked is the number of contiguous blocks 
to save: 


INPUT THE NUMBER OF 8K BLOCKS (1-8) 
For the whole cartridge space, type in 4. 


The COLECO LOADER now saves the file m@ disk, displaying on 
the CRT: 


SAVING FOOBAR.4 CHECKSUM=4444444 
SAVING FOOBAR.5 CHECKSUM=5555555 
SAVING FOOBAR.6 CHECKUSM=6666666 
SAVING FOOBAR.7 CHECKSUM=7777777 


After saving the file, the program redisplays the main menu. 
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4 — MOVE FROM CARTRIDGE TO FROB MEMORY 


This option copies the programs stored in ROM on the 
cartridge into the 32K of RAM memory within the Frob Interface 
Unit. You select this option by typing a '4', followed by 4 
Return key. The next thing you will see are the block checksums: 


THE BLOCK @ CHECKSUM IS 2000009 
THE BLOCK 1 CHECKSUM IS 1111111 
THE BLOCK 2 CHECKSUM IS 2222222 
THE BLOCK 3 CHECKSUM IS 3333333 


After performing this operation, the COLECO~ LOADER 
redisplays the menu. 


5 — DISPLAY FROB CONTROL PARAMETERS 


This option prints out the status of software parameters 
selected by the user. Selected choices may include the memory 
space selected, the storage space selected, and write protection 
information. This option can be viewed by typing a '5', followed 
by a Return key. The following is an example of a display: 


INTERFACE IS WRITE PROTECTED 
I/O SPACE IS SELECTED 


After displaying the status, the main menu is redisplayed. 
The LEDs on the front panel of the Frob Interface Unit provide 
the same information continuously. See Chapter 3, section 3.1.2 
for further details on the LED indicators. 


6 — SET FROB CONTROL PARAMETERS 


This option allows you to configure the hardware on the 
Frob-Coleco development system, selected by typing a '6', 
followed by a Return key. The first question asked is: 


MEMORY SPACE OR 1/0? (M/I) 


This option allows one to choose whether access will be to 
the Colecovison or its I/O space. 
(* 
HOLD COLECO BUS? (Y/N) 


If the bus is held, processing stops, preventing the 
ColecoVision fram running its program. As we use static RAMs, 
memory stays intact. Control is turned over to the RAM of the 
Frob Interface Unit. = 
(*) 


All references to Coleco are ColecoVision 
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RESET COLECO? (Y/N) 


Resetting the ColecoVision makes the ColecoVision act as if 
it were just powered up. It will go through its entire 
intialization process, . assuming that the bus is not held. Note, 
however, the reset must be turned off to start the program. 
Options 7 and 8 below do this function automatically by turning 
on the reset to reinitialize the ColecoVision and then turning 
off the reset to start the program in either the Frob Memory or 
the Coleco ROM. 


SELECT CARTRIDGE? (Y/N) 


Either the cartridge or the RAM area in the Frob—Coleco 
Interface Unit can be active, as they both map into the same 
Coleco address space. ‘'Y' will select the program in the 
cartridge. Answering 'N' will select the program in the Frob 
Interface Unit RAM space. a 


WRITE PROTECT INTERFACE? (Y/N) 


This option allows you to prevent writes into the RAM area 
on the Frob-Coleco Interface Unit. This is useful while 
debugging programs, as it will prevent your code from being. 
‘clobbered' or erased by a wild, out-of-control program. 


At this late juncture, the COLECO LOADER summarizes your 
selections. They may be as follows: 


I/O SPACE IS SELECTED [or MEMORY SPACE IS SELECTED] 
BUS HOLD IN PROCESS 


To safely run a software program stored in the RAM of the 
Frob Interface Unit, the following combination of choices is 


appropriate: 


I/O SPACE IS SELECTED (or MEMORY SPACE IS SELECTED) 
INTERFACE IS WRITE PROTECTED (optional) 


7 — RESET AND RUN PROG IN FROB MEMORY 


By typing a '‘'7' followed by the Return key, you will 
automatically initialize the ColecoVision and select the program 
in the Frob Interface Unit. This is a fast way to perform this 
action. 
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8 — RESET AND RUN PROG IN COLECO ROM 


Typing an '‘'8' followed by a Return key, will reset the 
ColecoVision and select the program in the ColecoVision ROM 
cartridge and run the program in ROM. ; 


9 — EXIT . 


This option, selected by typing a '9', followed by a Return 
key, stops the Coleco Loader program, bouncing you back to 
Applesoft. 
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2.2 THE LAZER Z-8@ MONITOR SOFTWARE 
2.2.1 Introduction | 


Similiar in same respects to the Coleco Loader software, the 
LZRMON program allows you to execute, examine, and debug 2-88 
machine language programs directly on the ColecoVision system. | 
Of the two pieces of software, the “LZRMON is the more 
sophisticated, offering more system status information . and 
greater debugging capabilities. It also requires more time to 
learn and more hardware. 


Use of the software requires an Apple II, I+, or IIe with 
64K RAM and a MicroSoft 2-88 Softcard (or hardware equivalent) 
running the CP/M operating system. The MicroSoft ALDS assembly 
language development package is another extremely useful tool 
worth having. 


The Apple Card connecting to the Frob Interface Unit must be 
placed in slot #2. 


The CP/M disk included with your Frob unit includes two 
files: LZRMON.COM and DBUG.FRB. The LZRMON program is the 
actual 2-88 monitor program; the DBUG.FRB file is a debugger 
program that loads into the ColecoVision memory space. 


2.2.2 Execution Procedure 


To execute the Lazer Monitor program, type "LZRMON" (or 
"B:LZRMON" if your Frob disk is in drive B:) followed by the 
Return key. 


This comand loads and runs the monitor program. You will 
then be presented with a short menu offering the following 


options: 
2.2.3 Primary Menu Commands 


Insert the Lazer Z-@@ Monitor Disk into the Apple Drive 1 
(one) and boot it up. Type: LZRMON and you will see a menu: 
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Cc COPYing the data fram the cartridge slot into the Frob RAM. 
This command copies the entire 32K present in the cartridge 
space. The Copy command is executed by pressing "C". 


L LOADing a binary file fram disk into the Frob memory. This 
command is executed by pressing "L". 


Keep in mind that the LZRMON program only allows a file to 

be loaded onto a 256—byte page boundary. After you press 
"L" you will be asked which page you wish the file to. be 
loaded onto. The desired starting page number must be 
entered in HEX for loading your 2-88 machine language 
program and be ORG'ed (originated)in $81 or above. This 
allows room for Lazer's debugger program, DBUG.FRB, to 
reside in page $8. 


M The MONITOR command halts the ColecoVision and places you 
into the LZRMON monitor mde. This is accomplished by 
pressing "M". See the following section for further 
details. 


Try NOT to enter the LZRMON monitor mode when sound is being 
generated by the ColecoVision, as the system bus is held by the 
Frob in the current ColecoVision processing steps. The steady 
state of sound can be quite annoying when in the monitor mode. 
This phenomenon also happens with video information. 


R RESETting the ColecoVision is accomplishing by pressing the 
"R" command. This begins execution of the 2-88 program 
stored in the Frob RAM memory. If you want to execute a 
cartridge program you must first copy the cartridge into the 
Frob RAM space with the "C" command. 


Ss SAVING a file to disk fram the Frob program memory is done 
by executing the "S" command (i.e., S @.FF). You will be 
asked to enter starting and ending page numbers. These 
values may be in the range $08 . . . SFF, allowing you to 
save the ColecoVision monitor ROM or RAM values to disk. 


Q QUITting the LZRMON program is accomplished by pressing the 
"Q" command. You are returned to the CP/M operating system. 


2.2.4 The Monitor Mode 


The Lazer monitor was designed to resemble the Apple's 
native 6582 monitor program. Anyone familiar with the Apple's 
monitor will feel right at home with the LZRMON monitor program. 
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The monitor program provides the means for easily examining 
and modifying memory (or 1/0 ports), disassembling 2-80 
instructions, moving memory around (including moving data between 
main memory and VRAM), resetting the ColecoVision, setting — 
breakpoints, and executing Z-88 programs. 


When the main menu asks for a command reponse, — type "M" to 
enter the monitor mode. In the monitor mode you are greeted with 
the prampt message "MEMORY: "| It is the first of three standard 
prompts: “MEMORY:", "VRAM:", and "PORTS:". 


The "MEMORY:" prompt tells you that all monitor cammands 
following the prampt operate on the Z-88 64K memory space. 


The lower 32K corresponds to the ColecoVision monitor ROM, 
RAM, and other unassigned locations; the upper 32K of the memory 
space corresponds to the 32K of RAM found in the Frob unit. 


Although the TI 9928 VDP (Video Display Processor) in the 
ColecoVision addresses 16K of VRAM (Video RAM), it is NOT 
directly addressable by the 2-80 microprocessor chip. However, 
special provisions have been made in the LZRMON program to allow 
you to view the VRAM as though it were directly addressable. 


Vv You can place the monitor program into VRAM mode by typing 
"7" after the monitor pranmpt. In this mode all memory 
accesses will reference the 16K of VRAM on the TI 9928 VDP 
instead of the 2-80 64K address space. As there are anly 
16K of VRAM (instead of the 32K of RAM), all addresses 
beyond $3FFF are truncated to 14—bits, and put you back 
into the range $0000 . . - $3FFF. While in the VRAM mode 
the monitor prompt is "VRAM:". For example, if you type in 
SFFFF, VRAM Location address would be $3FFF. 


As the 7-0 can address 256 1/O ports (in addition to the 
64K of RAM and 16K of VRAM), provisions have been made to allow 
you to directly access I/O ports fram the monitor program. 


I Pressing "I" after the monitor prampt places the Lazer 
monitor program into the "PORTS" mode. You will be greeted 
with a "PORTS:" prampt and all memory references will access 
the 2-88 I/O ports. instead of memory. . 


NOTE: Because of the operation of the MicroSoft 2-8 
Software, same timing-dependent peripherals may not operate 
properly when referenced by the LZRMON monitor program in "PORTS" 
mode. For example, the VRAM accesses had to be handled by 
calling 6582 routines fram the 2-80 code in the Lazer Monitor 
program. Though most peripherals available fram the ColecoVision 
unit should work just fine, it's good to be aware of this little | 
peculiarity. Port address may be corrected in a future release of 
this software if users report any difficult problems with the 
code. 
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As the Z-88 can only address 256 different I/O ports, all 
addresses while in the "PORTS:" mode are truncated to eight bits. 


N The "“MEMORY:" prompt will appear by default anytime you 
enter the LZRMON monitor mode from the main menu. If you 
switch over to VRAM or I/O ports using the 'V' OR 'I' 
command, you can return to the memory mode by pressing "N" 
(for Normal memory) after the "VRAM:" or "PORT:" prampt 
message. 


Xx This command will eXit you fran wherever you may be 
within the monitor mode to the main LZRMON menu. 


2.2.5 Displaying and Modifying Memory 


The Lazer monitor program can display and modify the 
contents of any Z-8@ memory location, VRAM memory location, or 
I/O port. As outlined in the last section, the type of memory 
access is specified by the "N", "“v", and "I" commands. The 
monitor prompt specifies the type of memory access that will take 
place. 


To display a single memory location, type the address of the 
location (in hex) you wish to display, followed by a return. The 
Lazer monitor program will respond by printing the data stored at 
that location. 


You can print the next eight additional, sequential memory 
locations by pressing return. Each time you press return the 
next eight memory locations will be displayed. The output of the 
Lazer monitor program will display on either a forty- or eighty- 
column screen. 


To display a range of memory locations, type the first and 
last memory locations you want displayed, separated by a period. 
For example, the command "8000.897F" displays the contents of 
memory locations $8000 . . . $807F. The data is displayed eight 
bytes per line (it fits within 48—columns)’, with a maximm of 
about $9F values on the screen at any one time. 3. | 


You can send this data to the printer (located in Apple slot 
#1) by typing control-P at the beginning of the line (which turns 
the printer am). You can then print as much data as you baie 
the printer capturing it all. 


More information on displaying memory locations is available 
in the Apple reference manual. 


To modify sequential memory locations, use the ae 
operator. The syntax for the memory change conmand is: 


<<address>>: <<data>> 


< 
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where <<address>> is a valid 27-88 memory, port, OF VRAM 
address and <<data>> is a collection of one or more single byte 
hexadecimal values, separated by spaces. If two or more data 
values follow the colon then these values are stored in 
sequential memory locations starting at address <<address>>. 


Examples: 
8034:22 55 76 34 93 2C 
FFO0:0 9 @ GB SC 36 
18@8:123 AC 


2.2.6. Moving Memory Around 


The Lazer monitor program provides a mechanism for moving 
around blocks of memory in the Z-8@ memory and VRAM spaces. The 
syntax for the move command is: 


<<destination>> < <<start>>.<<end>>M 


where <<destinatiom>> is the destination address where the 
data is to be moved to, <<start>> is the address of the source 
block, and. <<end>> is the address of the last byte to be moved. 
For example, the command: 


FFOO<8020 . SOFEM 


moves the block of memory $8000. - - S8@FF to locations 
SFFQO . . . SFFFF. 


The block move command does not consider situations where 
the two blocks overlap. If you are moving data fron a lower 
memory address to a higher memory address and the blocks overlap 
certain sections of the data will be duplicated. This allows you 
to fill memory with a specified value. For more information on 
this technique consult the Apple reference guide. 


The standard block move command always moves data around in 
the current default memory space (MEMORY or VRAM only). 


Sometimes it is useful to move data fran the VRAM to main 
memory or from main memory to VRAM. This is accomplished with a 
simple extension of the Lazer monitor move command. By 
immediately following the "y" with a "Vv" you can transfer data 
between the MEMORY and VRAM spaces. 


If the current memory mode is "MEMORY:"" and the monitor 
command is of the form: 


<<dest?> < <<start>>.<<end>>MV 


then data is copied . fram 7-88 memory locations 
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<<start>>.<<end>> into VRAM locations <<dest>> and up. If the 
‘Current memory mode is "VRAM:" when this comand is executed, 
data is copied from VRAM into the Z-8@ memory space. 


WARNING: Moving memory to <<dest>> can erase present memory in 
that location. 


2.2.7 Debugging Functions 


The DBUG.FRB Program and the "G" Command 


G The Lazer monitor "G" ccammand ("G" for GO) initiates 
cammunication with the special debugging program for the 
ColecoVision System. 


For the "G" command to operate, you must first load the 
DBUG.FRB program into the ColecoVision's memory space. Although 
the program data is in the ColecoVision memory space, the program 
physically resides in the Frob 32K Interface Unit. Using the "L" 
cammand from the main LZRMON menu, load DBUG.FRB in at location 
$8808 (page $80). 


As this program is roughly 512 bytes long, it is advisable 
to ORG your programs at location $8488 or higher, leaving plenty 
of room for the debugging monitor program. If you plan to use 
all 32K of RAM for your program, however, the debugging monitor 
program can be displaced or replaced with a smaller program. 


There are three allowable syntaxes for the G camnmand. They 


are: 
Example 
<<run address> >G FYOSBG 
<<bptl>>.<<run address>>G FQ10 .FOQGG 
and 
<<bpt2>> < <<bptl>>.<<run address>>G FQ305<5FO10 . FOOOG 


The first form simply runs the program at the specified 
address. The second form allows you to set a single breakpoint. 
The third form of the G command allows you to set two. break- 
points. 


2.2.8 Breakpo ints 


Breakpoints are locations in memory that stop a program from 
running. They help the programmer trace the flow of events 
eccurring within a program and are particularly useful when a bug 
is being tracked. With well-placed breakpoints, you can see 
where things begin to go awry. 
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Breakpoints are extremely useful when running a new 
ColecoVision program in the Frob Interface Unit memory. Also 
useful for testing and experimentation, they work by storing a 
RST 56 instruction at a specified memory address. While the 
program is operating, the DBUG.FRB program will recognize and 
then intercept RST 56 calls, display memory registers and program 
parameters, and then return system control to the Lazer monitor. 
This will happen whenever an RST 56 instruction is stumbled upon. 


As a programmer, you do not physically have to put a RST 56 
instruction in your program for a breakpoint. LZRMON will 
automatically do that for you when you ask for a breakpoint. 
However, the DBUG program does not remove the RST 56 instruction 
after encountering it. 


This is very useful for testing purposes, but not something 
you want to happen in your final program. 


It is important that you remove the RST 56 instructions from 
your program after testing is completed. 


2.2.9 Monitor Communications 


Once control is transferred from the system monitor, LZRMON, 
to the primary menu, you still have three forms of canmmunication 
with the monitor: 


1) You can call your routine fran the monitor with a CALL 


2) You can terminate program execution with a simple RET 
instruction. It is preferred that you terminate your program 
using the DBUG.FRB program and the breakpoint processor. 


3) You can also print HEX or ASCII data on the Apple's video 
display by sending a special sequence of commands to the Frob 
I/O port. 


This last form of commmication is made possible by the IN 
7CH and OUT 7DH instructions (both 2-80 instructions). Port 7C 
is known as the Frob status register. If bit seven is high, you 
can then transfer data to the Apple through port 7DH. If bit 
seven of port 7CH is low, then you mist wait until it is high. 
It must be high to transfer data. 


To print an ASCII character on the Apple screen, output a 
one (the Value, not the character) to port 7DH, watch for the 
byte to be ‘taken’ (bit 7 of port 7CH to go high), and then send 
the ASCII character you want printed through port 70H. 


If you prefer to print a byte as two hex digits, output a 
two (the Value, not the character) to port 7DH, watch for the 
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byte to be 'taken,' and then send the hex byte you want printed 
through port 7DH. 


Normally the Lazer monitor sits in a tight loop looking for 
output cammands or a camand byte specifying the end of 
execution. You can get the Apple to break this loop at any time 
by pressing the Return key on the Apple's keyboard. 


If your Z-88/ColecoVision program gets stuck in an infinite 
loop, you can get out of it by pressing the Return key (returning 
you to the Lazer monitor). Then hit the Return. key again to reset 
the ColecoVision. If the program terminates from a breakpoint 
execution, all of the Z-88 registers will be displayed. Like the 
control panel of an aircraft, this feature allows you to check 
the current states of the machine at a given point. 


2.3.9 Lazer Mini-disassembler 
Built into the Lazer monitor is a mini-disassenbler that 
allows you to view code sequences in the Z-80 memory space. The 
syntax for this command is identical to the Apple's: 
<<address>> L 
This command lists out 28 Z-88 instructions to the screen 
using standard Zilog memonics. 


2.3.1 The Lazer Monitor List Commands 


<<adrs>> Displays the contents of memory 
location <<adrs>> 

<<adrsl>>.<<adrs2>> Displays the contents of the 
memory locations in the range 
<<adrsl>> . . . <<adrs2>>. 

<<adrs>> : <<data>> Sets sequential memory locations 
to the values specified by. 
<<data>>. 

<<adrs>>L Disassembles and lists 28 
instructions at the specified 
address. 

<<adrs>>G Executes the 2-88 subroutine at 


the specified address. 
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<<al>>.<<a2>>G Sets a breakpoint at address 
<<al>> and begins execution at 
address <<a2>>. 


<<al>> < <<a2>>.<<a3>>G Sets two breakpoints at addresses 
<<al>> and <<a2>> then executes 
Z-8G code beginning at address 
<<a3>>. 


Cc Copys data fram cartridge slot to 
Frob RAM. 


<<dest>> < <<al>>.<<a2>>M Moves data fram address <<al>> 
<<a2>> to <<dest>>. 

<<dest>> is always in the same 

memory space as <<al>> and <<a2>>. 





<<dest>> < <<al>>.<<a2>>MV Moves the data from the currently 
selected memory space (memory or 
VRAM) to the other memory space. 





G Initiates DEBUG.FRB program. 

I Selects I/O port addressing. 

L Loads binary file from disk to 
Frob memory. 

M Halts ColecoVision, entering 
MONITOR mode. 

N : Selects normal memory addressing. 

R Resets the ColecoVision. 

Q Quits LZRMON program, returning to 
CP/M. 

s Saves Frob program memory to disk. 

V Selects VRAM addressing. 


x Exits to the main LZRMON menu. 
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Chapter 3. ANATOMY OF A FROB 


3.1 THE FROB INTERFACE UNIT 


The Frob Interface Unit uses the Apple memory addresses _ 
associated with the Apple I/O card slot. The 16 location device 
space is used for control, and the 256 1/0 space (usually used 
for ROM) is a one page window into the address space of the 
ColecoVision. To the Apple, the ColecoVision memory looks like 
128 pages (256 bytes/page) of memory. The Interface has 32K 
bytes of static RAM that operate in the ColecoVision address 


interface memory. 


3.1.1 Page Register 


The 256 byte window in the Apple address space can be mapped 
to any page in the ColecoVision address space by sending the 8- 
bit page number to the Page Register. This value will be used as 
the upper 8 bits on any access to the ColecoVision. 


EXAMPLE: 


Suppose we want to stop a cartridge running on the 
ColecoVision to examine the contents of one of the ColecoVision 
RAM locations. Assuming the Frob-Apple interface card is in slot 
2, and the RAM location we want to see is at 6@55H in the 
ColecoVision, the steps are as follows: 


1. Write @AH to location C@ACH. This stops the ColecoVision by 
setting BUSREQ. It also sets ROMSEL, but that must have already 
been set for the ColecoVision to have been running a cartridge. 


2. Write 60H to location QJADH. This sets the one page window 


to the address range 6000H to 6@FFH in the ColecoVision. (This 
could just as well have been done before the step above. ) 


3. Read location C255H. This is now mapped to 6055H in the 
ColecoVision. We could also write to it if we want to change its 
contents. - 


4. Write @8H to location QJACH. This gives the bus back to the 
ColecoVision processor and allows it to continue with its 


program. 
3.1.2 Bidirectional Port 


The Interface has a bidirectional I/O port with handshaking 
between the ColecoVision and the Apple. The port is in the 
ColecoVision I/O space on its side and so does not use any of the 
cartridge memory locations. 
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The bidirectional port permits a program in the ColecoVision 
to cammmicate with a program that is rumning in the as This 
port consists of a data and a status register. 


DATA REGISTER: 


The data register of the bidirectional port is a simple 
holding location for data passed between the two machines. It is 
analogous to an air lock between a space station and a supply 
ship. People and supplies must pass through this bidirectional 
air lock, leaving the atmosphere in both vehicles intact. 
Operators on both vechicles check to see if the pressure in the 
airlock is the same (compatible) with their ship's atmospheric 
pressure before the door between the ship and the air lock is 


opened. 
STATUS REGISTER: 


The status register is similiar to the internal status 
register of a UART. Similiar to the pressure indicating devices 
in the air lock of the space station, Bit 7 (Most Significant 
Bit) of this register indicates whether or not the data register 
is ready to accept data. If bit 7 is true (high=me), then the 
data register is empty and is ready to accept data. If Bit 7 is 
false (low=zero), then the data register has data in it and is 
not ready to accept data. If bit 6 is true (high), data is 
waiting in the data port fram the other side (either the Apple or 
the ColecoVision). It is important that these status bits are 
checked when data transfers are made, as it is possible to write 
over the data in the data register, even when the status bits 
indicate that the data register is full and not ready to accept 
data. 


3.1.3 LED Indicators 


The Frob Interface Unit uses LED indicators for showing you 
the status of the unit. These status signals can be manually 
Changed using the Coleco Loader, command number 6. The LEDs may 
be interpreted as follows: 


LED i INTERPRETATION 
1l- RST Reset in progress. 
2- MEM Memory space is selected. 
3+ HOLD | ColecoVision bus is being held. 


4~ 1/0 I/O space is selected. 
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5- we (Write Protect) This LED is illuminated when Bit 4 of 
the Frob Control Register is set. 
This prevents writes to the Frob 
memory from the Apple or 
ColecoVision. 


6- CART (Cartrige Select) This LED is illuminated when Bit 3 of 
the Frob Control Register is set. 
This indicates that the ColecoVision 
ROM is accessible at locations 8000 - 
FEFF. 


POWER ColecoVision power switch is on. 


Sections 3.1.4 to 3.1.6 will be of great use to programmers 
who wish to write their own operating system or modify the 
existing software for the Frob-Coleco hardware. Both the Apple 
Development program and the LZRMON software were based on the 
following hardware data. 


Reading these sections will allow cme to become more 
familiar with the internal architecture of the Frob Development 
System. 


3.1.4 Device I/O Locations 
The Apple side map. looks like this: 
DEVICE I/O LOCATIONS @F (For slot 2, CAG to COAF ) 


not used 

Control Register, write only 
Page Register, write only 
Status Register 

Interrupt. ColecoVision 
Data fran ColecoVision to Apple 
Data from Apple to ColecoVision 


: 
uit 


3.1.5 Control Register Bits 


Bit @ —  IORQ If IORQ is set, then an access from the 
Apple to the ColecoVision will be to the 

I/O space of the ColecoVision. If IORQ 

is zero, an access will be to the memory 


space. 


Bit 1 — BUSREQ If BUSREQ is set, the interface will 
assert BUSREQ on the ColecoVision. This 
will hold the processor and allow the 
Apple to get at the ColecoVision memory 
or I/O space. 
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Bit 2 -—- RESET If RESET is set, the interface will 
assert the RESET line o™ the 
ColecoVision. This will hold the 
processor and allow bus access as in 
BUSREQ, but when reset is cleared, the 
ColecoVision will vector through its 
reset vector. 


Bit 3 —  ROMSEL When set, this bit selects the 
ColecoVision cartridge to be in the 
ColecoVision address space fram 8Q@00H to 
FFFFH. If ROMSEL is not set, this space 
is filled by the RAM on the interface. 


Bit 4 --  WPROT If this bit is set, the RAM on the 
interface is write protected. 


Bits 5-7 -— not used 


3.1.6 I/O Ports 


The ports between the Apple and ColecoVision have two "data 
status" bits. If you read the Status Register on either side, 
Bit 7 will be high if it is ready to send data, and Bit 6 will be 
high if the port has data for you fram the other side. 


The Status Register is at location 7CH in the ColecoVision 
I/O space, with the Data Register in the next location at 7DH. 
The Apple can get at both sides of this port structure because it 
can access both the ColecoVision memory and I/O space. We have 
found this useful only for testing the ports. 


When the Apple writes to device location @EH (i.e. C@AEH for 
slot 2), the interrupt line of the ColecoVision 288 will be 
pulled low. Though of no obvious use, this observation is a way 
of obtaining the attention of the Z8@ without sending it through 
the reset structure. 


3.2 Frob-Apple Interface Card 


The Frob-Apple Interface Card is the PC board that plugs 
into slot #2 of your Apple camputer. Once in place, it gives 
your Apple access to the Frob Interface Unit and the 
ColecoVision, with the ability to store your programs on your 
Apple disk storage system. Install it and forget it. 


3.3 Frob-Coleco Cartridge Adapter 


The Frob-Coleco EPROM cartridge adapter plugs into the 
ColecoVision cartridge slot. It has four sockets which will hold 
four 2764 (8K) EPROMS. This adapter and “burned" EPROMS (a 
maximm of 32K) is your demo cartridge. It will plug into any 
ColecoVision system cartridge slot for demonstration purposes. 
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Appendix A. Inside the ColecoVision 


A.1 Memory Map for the ColecoVision 


Address Range: Function: 
QH-LFFFH ColecoVision monitor ROM 
800CH-FFFFH Cartrige memory range 


The ColecoVision has 490 hex (1024 dec) bytes of read/write 
memory. This memory image is duplicated in eight different 
address ranges. For example, a write to location 6000H accesses 
the same memory location as a write to location 640@H. 


This read/write memory resides in the following ranges: 


6000-—63FF 

6490-—67FF 

6800-CBFEF 

6CQO—6FFF 

7000—-73FF (Coleco uses this address range in their monitor.) 

7490-7 7EF 

7800~-7BFF 

7COO-7FFF 

A.2 1/0 Map 

Port Address Name © Read Function Write Function 

a ee eee amen 
G80H KEY —_— Select keypads 
QCOH JSTK —- Select joysticks 
@BEH VRAM VRAM. data VRAM data 
@BFH VDPR ss  ———- Video registers 
OBFH VSTAT Video status _— 
@FCH CTROL1 Controller 1 data ---- 
OFFH CTROL2 Controller 2 data —-—- 
OFFH AUDIO _ Send data to sound 


Each game controller has both a keypad and a joystick. The 
hardware at the interface maintains a select flip/flop that 
chooses which data (keypad vs. joystick) is returned when the 
processor reads the CTROL port. 
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A.3 The ColecoVision Monitor Disassembly Introduction 


The ColecoVision Monitor will become more understandable if 
you are familiar with the Z-89 instruction set, the TMS9928A 
(Texas Instruments) video display processor, the SN76489AN 
(Texas Instruments) sound generator and the construction of 
monitors in general. 


The Monitor is an 8K program residing in locations 9 to 
lFFFH. Typical of Z-8@ machines, the processor executes the 
monitor at location @@@@H after powerup. At this location, the 
stack pointer is set and program initialization takes place. 


This program provides the software developer with many 
ready-made routines to expedite the software writing process. 
These fall into four general classes: sound drivers, video 
drivers, game controller drivers and data structure manipulation 


programs. 


Frobco provides a commented disassembly of the Monitor in 
order to allow programmers to use these routines in their 
programs. We have worked through the driver routines and many of 
the data structure routines. The advanced structure manipulator 
routines have been left to the programmer. If you wish to use 
these routines we suggest you disassemble same Coleco games and 
look at another progranmer's use of the ColecoVision Monitor. 


Many routines have dual entry points (two dispatch addresses 
in the main jump table). One entry takes parameters directly in 
the processor registers, whereas, the other gets the same 
parameters fram list pointers and descriptor tables. In order to 
use the routines of the Monitor, it is necessary to became 
‘skilled with their calling sequences, returned values, and side 
effects. -.We recommend that the programmer study the disassembly 
and construct test calling routines. 


When using the monitor routines, ome should always remember 
that the Monitor probably has bugs. Over time Coleco has 
probably constructed a bug list to keep their progranmers out of 
trouble. Frobco does not have this information, and makes no 
claim that any routine works the way you think it does. So be 
very careful. 





Frob-Coleco User's. Manual 
A.3.1 Relevant Cartridge Locations 


The Monitor examines several locations at the beginning of 
the Coleco cartridge and bases its actions on the values stored 
there. Here are just a few: 


Location Meaning 


2800GH + If 8880 contains a 55 and 8@@1 an AA, then 
G8901H immediately jumps indirect through location 


8@@A without performing any initialization. 

_I£ 8000 contains an AA and 8@@1 a 55, then 
the monitor puts up an introduction before 
starting the cartridge. 


G80AH - Contains the starting address of the program in . 
the cartridge. 

BEBBC - Jump vector for RST 1 instruction 

SBQGF - Jump vector for RST 2 instruction 

88912 - Jump vector for RST 3 instruction 

98815 - Jump vector for RST 4 instruction 

98818 - Jump vector for RST 5 instruction 

2801B - Jump vector for RST 6 instruction 

G801E - Jump vector for RST 7 instruction 

08921 - Jump vector for the NMI service routine 


(Non-maskable Interrupt) . 
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A.3.2 Significant Memory Locations 
The Monitor uses some memory locations in the 97308 page: 





Location Meaning 

97820H - Pointer to the base of an array of sound control 
tables. 

07922H - Pointer to a sound program for the noise part 
of the sound chip. 

079248 ~- Pointer to a sound program for tone generator 1. 

@7026H ~ Pointer to a sound program for tone generator 2. 

97828H - Pointer to a sound program for tone generator 3. 

0792AH ~ Shadow of the last noise control code sent. 

973B9H - Stack pointer (grows down). 

07 3BAH - Start of an area used to store parameters pass 
to routines called through PCOPY. 

@73C3H - Shadow of VDP register #2. 

073C4H ~ Shadow of VDP register #1. 

973C7H - Flag used by the RAM copy routine. 

@73C8H - Pseudo-random number seed. 

073EBH ~ Counter for roller controller #1. 

073ECH - Counter for roller controller #2. 

07 3EEH ~ Shadow of controller #1 joystick. 

073EFH - Shadow of controller #2 joystick. 

07 3FOH - Shadow of controller #1 keypad. 

@73F1H ~ Shadow of controller #2 keypad. 

073F2H - Table of words containing the actual base 


addresses of the various VDP tables. This table 
is indexed by 2*VDP register code. 
073FEH - Temporary 2 byte store location. 


A.3.3 Initialization 


Initialization starts at location 9008, the stack pointer 
set to 73B9. The program then jumps to Q@@6E, continuing 
initialization. 


The Monitor first checks cartridge locations @8000-08001 to 
see if the cartridge should be executed inmediately. If so, it 
jumps indirect through location @8@@A. If not it calls dispatch 
#27H, initializing the sound generator. The program then stores 
a @833 to location @73C8 to seed the pseudo-random mumber 
routine. 


A routine is then called at location 1195, selecting the 
keypads and setting same variable locations to zero. These 
variable locations are then specified by the contents of 98008 
88609 in the cartridge. After clearing two more memory 
locations, the monitor jumps to the routine at 1319. 
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The routine at 1319 continues the initialization process, 
calling yet another routine at location 18B4, clearing the entire 
VRAM memory. And then a routine at location 18E9 is called, 
initializing the VDP registers. 


There are two primary routines called by the routine at 
18E9. The first is at LFD9 and is mainly used to program and 
shadow VDP registers 1 and 2 and to program (but not shadow) 
register 7. The second routine is at 1FB8 and is called to 
initialize VDP registers 2,3,4,5 and 6. 


These 5 registers all take a base table address as part of 
their programming. The routine at 1FB8 shadows the base address 
in a table indexed by a register number at location O73F2. It 
then translates the actual memory location into a code in a 
format acceptable to the appropriate VDP register. 


Next, a routine at 1927 is called, copying the font table at 
158B into the VRAM. 


All of the necessary tables are then loaded into the VRAM 
area using the routine at 1FBE. 


The monitor then checks to see if cartridge location 08000H 
has an 'AA' in it and location 98@@1H has a '55' init. If so, 
it does an indirect jump through location @8@0AH to start the 
cartridge program. If not, the monitor puts up a message telling 
the user to turn off the machine before inserting the cartridge 
or system adapter. If this is left alone, it times out, turns 
off the screen, and loops forever. 


VRAM base addresses are initialized as follows: 


Name Table 1800H 
Color Table 2000H 
Pattern Generator 9%000H 
Sprite Attribute 1BQ0H 
Sprite Pattern 3800H 


A.3.4 The Jump Table 


The jump table is located at the end of the Monitor, 
starting at location 1F61H and continuing to the end. This 
series of jump instructions will remain fixed. 


So, if you wish your cartridge programs to use Monitor 
routines, you should call them via the jump table entry points. 
Semetimes the monitor uses this jump table. Other times the 
monitor bypasses the table when using the jump routines. 


As mentioned above, there are dual entry points for same 
routines. Careful study of the parameter passing routine at 
96998 should be made to understand how to call routines with 
indirect parameter passing. 
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For further details about the function of the Monitor 
routines, refer directly to the commented disassembly of the 
Monitor contained in Appendix D. 
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COLBCOVISION SCHEMATICS 
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A.4.7 Expansion Port Pin Number and Signal Names 


3. DATA 3 

4. ADDRESS 14 

5. -MEM 4000-4FTF 
6. -MEM 2000-2FFF 
7. -HLT 


9. -NMI 
18. +INT 
ll. -BUSRQ 
12. DATA 1 
13. -RESET 


15. -—Ml 

16. DATA 7 
17. DATA 6 
18. ADDRESS 
19. DATA 4 
28. ADDRESS 
21. ADDRESS 


te 


Ww 


23. ADDRESS 
24. ADDRESS 
25. ADDRESS 
26. ADDRESS 
27. ADDRESS 
28. ADDRESS 10 

29. -ROM DISABLE 

38. -DIS COLECO DECODING 


OMAN AME Hh 


5l. 


53. 
54. 
55. 
56. 
57. 
58. 
59. 
66. 


. (FROM RF MODULATOR) 
. (FROM RF MODULATOR) 
. (FROM RF MODULATOR) 


-RESET SWITCH 


. AUDIO CLOCK (3.58MHZ) 


+RESET 


. ADDRESS 11 


ADDRESS 12 
-RESET/SYNC 
3.58 MHZ 


- N.C. 


N.C. 
ADDRESS 15 
ADDRESS 3 
~MCLK 
DATA 2 
ADDRESS 9 
DATA 5 
~-RFSH 
WAIT 
-INT 
—BUSACK 
-RD 

~MREQ 
~IORQ 
SOUND 

+12 VOLTS 
+5 VOLTS 
+5 VOLTS 
-5 VOLTS © 


(Revised - 2/14/84) 
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Appendix B. The TI 9928 Video Display Processor 
B.l Introduction 


The ColecoVision's graphics capabilities are impressive, 
effective usage of the Texas Instrument — 9928 Video Display 
Processor chip (VDP). This device generates all the necessary 
video, control, and synchronization signals used in creating a 
color graphics image on a home TV set. It also controls the 
storage, retrieval, and refresh of display data located in its 
own dynamic screen refresh memory. 


NOTE: For a detailed technical programming description of the 
9928, refer to documentation created for the chip by Texas 
Instruments. 


The VDP cammmicates with the ColecoVision 2-8 
microprocessor via an 8-bit bidirectional data bus. Three 
control lines, decoded fram the Z-8% address and enable lines, 
determine interpretation of the bus. Through this bus, the 2-80 
can write to VRAM, read from VRAM, write to VDP registers, and 
read the VDP status--important procedures to learn when 
progranming the ColecoVision. 


The VDP has its own 16K of dynamic RAM, separate and 
distinct fram the 64K of main system RAM. The contents of VRAM 
define many of the parameters of the TV image. The VDP also 
handles its own refresh for its 16K of memory. 


The video output of the VDP goes to an external video 
modulator. The output of the modulator goes to the TV set. 


-B.2 Sprites 


One of the most important concepts in computer graphics, a 
sprite is a specific pattern positioned on the screen by a set of 
horizontal and vertical coordinates. Sprites allow relative ease 
of programming for creating three dimensional moving graphic 
effects. They come in two sizes: 8 X 8 pixels and 16 X 16 
pixels. A pixel is the smallest point on the TV screen that.can 
be independently controlled. The sprites can be further 
magnified by 2 to 16 X 16 and 32 X 32 pixels respectively. 


Sprites exist on square two dimensional planes. Imagine 32 
transparent, rectangular windows. Now put one in front of the 
other, forming a giant sandwich of windows. Each window (or more 
appropriately, ‘'plane') is the hame of one sprite. Looking fron 
the front end, you would see 32 sprites, all at home mM each of 
their planes. Naturally, sprites in the front would partially 
block off the view of the sprites in the rear. This ‘blocking 
off' effect is the result of a priority system assigned to the 
sprites. 


Objects on planes closest to the viewer have higher 
priority. When the scenes on two different planes occupy the 
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same spot on the screen, the scene on the higher priority plane 
will be seen by the viewer. For me of the lower priority planes 
to be viewed, all planes in front of that plane must be 
transparent at that point. 


Remember, only one sprite is allowed per sprite plane and 
all area outside of the sprite itself is transparent. The 


sprite plane with the highest priority is called Sprite @ and the 


lowest priority is Sprite 31. 


There are two more planes behind Sprite 31. First, there is 
the pattern plane, used for non-sprite textual and graphics data. 
In an animation scene, for example, the pattern plane would 
contain parts of the picture that do not move, like the mountains 
or sky in the background. 


Behind the pattern plane is the backdrop. or background 
plane. It is larger than the other planes so that it can forma 
border around them and is always a solid color. 


The last plane in the hierarchy is called the External VDP 
plane. The TMS9928A allows the input of an external video 
source, either from a camera, video tape recorder, camputer CRT, 
or another VDP. This plane is not available ao the ColecoVision. 


The sprites, pattern plane, and background plane may also be 
thought of as independent video sources. Unlike single plane 
video display generators, the three sources can be combined to 
create a single image m™m the ColecoVision screen. 


Moving objects in the sprite system does not require 
repainting the entire display screen. By simply changing 2 bytes 
in the Sprite Attribute Table (located in VRAM), each of the 
sprites can be made to move smpothly across the screen. Remember 
also, the pixel definitions will remain with the highest priority 
plane at any spot. This hidden view capability is provided in 
hardware and requires no complex software algorithms to 
implement. 


A normal sprite is defined by an 8 X 8 pixel pattern stored 
in VRAM (8 bytes). A sprite can only be a single color. 
Wherever a 1 is stored in that pattern, the sprite will be 
colored and where it is a 8, it will be transparent. 


All the things that define a sprite, such as its color, 
coordinate position in its plane, and name are stored in a 
special table called the Sprite Attribute Table. Each set of 
attributes is 4 bytes. Since there are 32 sprites available for 
display, the table is 128 bytes long. Finding the attributes of 
a particular sprite is simply a matter of taking the sprite 
number times 4 plus the base address of the table. 


The first two bytes of each entry of the Sprite Attribute 
Table set the X-Y positional coordinates of the sprite on the 
screen (referenced from the upper left corner). The first byte 


B-2 


























Frob-Coleco User's Manual 


indicates the vertical distance of the sprite fram the top of the 
screen, in pixels. The second byte describes the horizontal 
displacement of the sprite fram the left edge of the screen. _ 


The third byte is the pattern address of the specific 
sprite. This number specifies what the sprite should look like 
and is a pointer to the Sprite Generator Table, where more 
detailed information about the sprite is stored. 


The fourth byte defines the sprite color (Refer to the TI 
9928 data manual, page 2-17, for the color hex assignments) . 


B.3 Size and Magni fication 


Size and magnification are used to define the resolution and 
relative area covered by the sprites. Once defined, they apply 
to all the sprites. The size also determines the resolution of a 
sprite. A size of zero (@) says that the sprite will be 8 X 8 
pixels and a size of ome (1) says it will be 16 X 16 pixels. The 
smaller the sprite, the more resolution on the final display. 


Magnification sets the relative area covered by the 
sprites. For a magnification setting of zero (8), the sprites 
are displayed as either 8 X 8 or 16 X 16, depending om the size. 
However, a magnification setting of one (1) doubles the area 
covered by doubling the area of each dot defined. An 8 X 8 
sprite would be displayed as 16 X 16, but with half the 
resolution, anda 16 X 16 would be displayed as 32 X 32, again 
with half the resolution. This feature allows large areas of the 
screen to be covered by large sprites, but with reduced 


resolution. The low resolution image is a lot more ‘plockish, ' 
and so less appealing to the eye. 


B.4 Example 


Let's create a three dimensional image fran sprites. 
Consider a scene where a flying saucer is zoaming over cars 
slowed in typical rush hour traffic. In the background is the 
city of San Francisco, the Transamerica pyramid building 
silhouetted by a beautiful sunset, as the sun sinks into the 
Pacific Ocean. 


To create this image, most of the background is "painted" on 
the pattern plane (similar to any conventional two-dimensional 
display). 


Starting from the point closest to you (the observer), there 


is a hitchiker with hir thumb out, hoping to catch a ride fram 


the rush hour people. Naturally, when the cars move past hir, 
they would appear to pass behind hir, yet stay in front of the 
city. This effect is readily achieved using the sprite system. 


Being in the foreground, the hitchhiker is displayed as 
sprites @ and 1 (in almost all cases, because of the limitions in 


B-3 





B-4 


Frob-Coleco User's Manual 


sprite size and color, it is often necessary to use multiple 
sprites to define a single image. These sprites are then moved 
sychronously across the screen as one image). Sections of the 
freeway cars would be drawn on sprites 2 through 12. Clouds in 
the sky are drawn fram 13 to 17. The setting sun, fram 17 to 20. 
Sprites 21 through 31 are left transparent.» 


The flying saucer may be created from any combination of 
sprites, breaking all the rules of foreground and background. 
One object can be created fram several sprites. I leave this up 
to your imagination..Perhaps our hitch-hiker will get a ride, 
‘desprite' it all. Perhaps s/he will discover new forms of hue— 
mur on other planes.... 
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Appendix C. The TI SN76489AN Sound Generator 
C.1 Introduction 


The sound system uses the very versatile SN76489AN digital 
sound generation chip by Texas Instruments. Is is easy to program 
and can create many complex, unusual sounds, including bizarre 
alien voices, comparable to today's professional arcade game 
chips. 


The SN76489AN is a dedicated sound chip. There is no costly 
overhead on the Z-88 microprocessor, the chip doing all the sound 
generation work itself. It has eight internal registers used to 
control the three tone generators and the noise source. The wide 
range of frequencies possible is created fram the input clock 
frequency on the chip which vibrates at 3.58 Mhz. Fun to play 
with, the output of this chip is sent directly into the modulator 
and then to the TV. 


For a full technical description of the SN76489AN sound 
generator and examples of how to program the chip refer to the 
Texas Instruments documentation that follows. 
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@ 
FEATURES | 
fl 5 
+ 3 Programmable tone generators 
oo oe 
* Programmable white noise generator 3 | 
¢ Programmable attenuation | 
re 
« Simultaneous sounds 
© ™ compatible ews 
» Up to 4MHz clock input * acto at [7 


a 
DESCRIPTION 


The SN76489AN digital complex sound generator is an 2*L/Bipolar IC 
designed to provide low cost tone/noise generation capability in 
Bieroproraen cr systems. The SN76489AN is a data bus based -1/0 peri- 


RECOMMENDED OPERATING CONDITIONS 


PARAMETER MIN TYP = MAX —sCUNITS 
Supply Voltage, Vee 4.5 5.0 5.5 V 
High Level Output 
Voltage, Voy (pin 4) 5.5 V 
Low Level Qutput 

mA 


Current, Tot (pin 4) - : 2 


Operating Free-Air 
Temperature, Th Q 70 °¢ 


* Part SN76489AN is identical to the SN76494N exceot that the maximum 
clock input frequency /s 4MHz (200kHz for the SN76494N). A “civide- 
by-eignt" stage is included in the input circuitry ana 32 clock ouises 
are required to load the data, compared to 4 pulses for the SN76494N. 
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INCORPORATED 
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OPERATION 


i. 


TONE GENERATORS 


Each tone generator consists of a frequency synthesis section and an 
attenuation section. The frequency synthesis section requires 10 bits 

of information (FO-F9) to define half the period of the desired frequency 

(n). FO is the most significant bit and F9 is the least significant bit. 

This information is loaded into a 10 stage tone counter, which is decremented. 
at a N/16 rate where N is the input clock frequency. When the tone counter 
decrements to zero, a borrow signal is produced. This borrow signal toggles 
the frequency flip-flop and also reloads the tone counter. Thus, the period 
of the desired frequency is twice the value of the period register. 


The frequency can be calculatad by the following: 
_ 


where N = fef clock in Hz 
n= 10 bit binary number 


The output of the frequency flip-flop feeds into a four stage attenuator. 
The attenuator values, along with their bit position in the data word, are 
shown in Table 1. Multiple attanuation control bits may be true simul tan- 
eously. ‘Thus, the maximum attenuation is 28 db. 

Table 1 ATTENUATION CONTROL 


BIT POSITION 
ao OAL CAA WEIGHT 


0 2 db 
4 db 
8 db. 


0 0 
0 1 
0 0 
l 0 16 db 
1 1 


- Q2 Ff 2 
- 2 AQ Oo FF 


OFF 
NOISE GENERATOR 


The Noise Generator consists of a noise source and an attenuator. 7ne 
noise source is a shift register with an exclusive OR feedback network. 
The feedback network has provisions to protect the shift register from 


being locked in the zero state. 


soe 
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TABLE 2 | NOISE FEEDBACK CONTROL 
FB CONFIGURATION 
0 “Periodic” Noise 
1 "White" Noise 


Whenever the noise control register is changed, the shift register. 
is cleared. The shift register will shift at one of four rates as 
determined by the two NF bits. The fixed shift rates are derived 
from the input clock. 


TABLE 3 NOISE GENERATOR FREQUENCY CONTROL 










SHIFT RATE 
N/512 
N/1024 
N/2048 








1 Tone generator #3 output 


The output of the noise source is connected to a programmable attenuator 
as shown in Figure 4-(see page 1i)< 


3. OUTPUT BUFFER/AMPLIFIER 


The output buffer is a conventional operational amplifier summing 
circuit. It sums the three tone generator outputs and the noise 
generator output. The output buffer will generate up to 10mA. 








To prevent oscillations in the output buffer, the output (pin 7) should 
be decoupled. This is done by putting 10 ohms in series with 0.1MF from 


pin 7 to ground ( see figure 2). 
4, CPU to SN76489AN INTERFACE 


The microprocessor interfaces with the SN76489AN by means of the 8 data 
lines and 3 control lines (We, CE and READY). Each tone generator requires 
10 bits of information to select the frequency and 4 bits of information 


to select the attenuation. A frequency update requires 4 double byte 
transfer, while an attenuator update requires 2 single byte transfer. 





If no other control registers on the chip are accessed, a tone generator 
may be rapidly updated by initially sending both bytes of frequency and 
register data, followed by just the second byte fo data for succeeding 
values. The register address is latcned on the chip, so the data will 
continue going into the same register. This allows the 6 most significant 
bits to be quickly modified for frequency sweeps. 


23s 
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5. 


CONTROL REGISTERS 
The SN76489AN has 8 internal registers which are used to control the 
3 tone generators and the noise source. During all data transfers to 
the SN76489AN, the first byte contains a three bit field which determines 
the destination control register. The register address codes are shown 
in Table 4. 
TABLE 4 REGISTER ADORESS FIELD 

RO RL R2 DESTINATION CONTROL REGISTER 
Tone 1 Frequency 
Tone 1 Attenuation 


Tone 2 Frequency 


Tone 3 Frequency 
Tone 3 Attenuation 


0 
0 
0 
0 
1 
1 
1 Noise Control 
1 


0 0 
0 1 
1 0 
1 1 Tone 2 Attenuation 
0 0 
0 1 
z 0 
1 i 


Noise Attenuation 
DATA FORMATS 


The formats required to transfer data are shown below. 


a REG ADDR DATA DATA 
LirpojRi {R2 | FS | F7 FB I FS x {FO FL, F2 .F3 | F4_ [FS 


BIT QO FIRST BYTE BIT 7 BIT 0 SECOND BYTE ae 
UPOATE NOISE SOURCE (SINGLE BYTE TRANSFER) nga tn 
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7. The microprocessor selects the SN76489AN by placing TE into the true 

state (low voltage). Unless Tf is true, no data can occur. when CE 

is true, the WE signal strobes the contents of the data bus to the 
appropriate control register. The data bus contents must be valid 


at this time. 


The SN76489AN requires approximately 32 clock cycles to load the data 
into the control register. The open collector READY output is used to 
synchronize the microprocessor to this transfer and js pulled to the 
false state (low vol tage) {immediately following the leading edge of 
fE. It is released to go to the true state (external pullup) when the 
data transfer is completed. 2 


The data transfer timing is shown below. 


DATA TRANSFER TIMING 





= 
ee 
oe-07 , ' 
FIRST SYTE SECOND BYTE 
; Figure 1. 
TABLES —S=S*@'UNCCTION TABLE* 


* This table is valid when 
the device is: 
(1) not being clocked, and 
(2) is initialized by pulling 
We and CE high. 





ye 








Avpio IN 
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PIN ASSIGNMENT 
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The table below defines the SN76489AN pin assignment and describes the 
function of each pin. 


SIGNATURE 
[of 





00(MSB) 


D1 
2 
03 
D4 
0s 
06 
07 
vec 
GNO 
CLOCK 
We 


READY 


AQUT 


PIN 


6 


15 
13 
"12 
ll 
10 
16 


14 


1/0 
IN 


IN 


IN 


IN 
IN 
IN 
IN 
IN 
IN 


IN 
IN 


QUT 


DESCRIPTION 





Chip Enable - when active (low) data 
may be transferred from CPU to the 
SN76489 AN . 


00 through 07 - Input data bus ehrougn 
whieh the control data is input. 


Supply Voltage (5V nom) 

Ground Reference 

Input Clock 

write Enable - when active (low), We 
indicates that data is available from 
the CPU to the SN76489AN. 

When active (high), READY indicates 
that the data has been read. When 
READY is low, the microprocessor shoulc 
enter a wait state until READY is high. 


Nowaxtarnal connector siemtd 
See ERS 


Audio Orive Out 
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‘ectrical characteristics over 


SN7EHRCAN 


recommended operating conditions (unle 
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ss otherwise noted) 


Ce 


Voy, bow Level eee ee 


Qutput Voltage Tout =z 2mA_ READY 


eee 


C 


2dB Attenuation 


gdB Attenuation 


kNbIO INPUT 


Toy High Level 
Qutput Current 10 
Vin High Level _. 
Input Voltage 09-07, We, CE, CLK 
Von Low Level 
Input Voltage B9-07, We, Ce, CLK 
1 
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EXTERNAL AUDIO OUTPUT INTERFACE 







Internally Generated 
Sound Signal 


-160UASS! yp 0 
wee ; we 
Cour 
AUDIO 
AMPLIFTER 
100 
JTF 


+1.5V (typical) 


iH 








- 


** These capacitance values are determined by the frequency response 


desired and the audio amplifier used. 


Figure 2. 


<8< 
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Switching Characteristics, Vor * Vy T. * 25°C 


PARAMETER TEST CONDITIONS TYP pmax | UNITS 


f tock? Input Clock Transition Time 
Clack Frequency (10% to 90%) 10uS 
Setup Time, t., DATA W.R.T. WE 



























eee es __tayare | of ft 
Hold Time, t, (see Figure 1) DATA W.R.T. READY a nS 


- e - & 
* TE Pulse: 0-3V, teasers? teay1=7ns 












SN76489AN 


TEST CIRCUIT 


Cou 


Figure 3. 


a 
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BLOCX CIAGRAM 


ee eee ee ee = 








mee aaa na +16 ——= + +2 Attenuation 
eo Tone Genaracer 91 ; 
| | 
; 7" °2 ttanuation t 
pect LE = | 
Tone Generator 92 — : 
ach : =~! 
2g pe 
ect | -—fo =} “7 pein 
i} 
: 2 ol < $$ | coneraeae 43 | i, | 
Jom | 
Bea A ee | 
4 4 Se = I 
ae | Cie in } Ge ee | 


a 


Ls ee en eee yee erreees eee ae, 


8 so-— 
Qa o- 





BLOCK DIAGRAM DESCRIPTION 


This device consists of three programmabie tone generators, a programmable 
noise generator, a clock scaler, individual generator attenuators and an 
audio summer output buffer. The SN76489AN has a parallel 8 bit interface 
through which the microprocessor transfers the data which controls the audio 


output. 


-10- 
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vec 
20KA 






OOER 
be DECOOE 


oz (1) 
3 @ 


SELECT 
SHitt 
RATE 


04 (3)- 
os (2 
06 


or 


rer 
CLOCK 


reacy (4) 


. 
' 


eo _o- 


ves a 6xo aucid 
Out Put 


Bl 2 ON SN7E494m) 


@-~ 


SN764894 / $N76494 SCHELOGIC 


Figure 4. 
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N package 


This duaiin-line package consists of a circuit mounted on a 16-ead frame and enczowuilated within an eeczicily 


nencanductive clastic compound. The compound will withstand scidaring temperature with ne deformation and circuit | 


pertermance characteristics remain statie when ocerated in high-numidity conditions. The sackage is intended for 
"insertion in mounting-neie rews on 0.300-ineh centers, Once the ieads are cameressed and inserted, sufficierrt cansicn is 


srovided to secure the cackage in he ocard during scidering, Leads require no additional cleaning or srecessing when 
used in soldered assembty. 


1GPIN N PLASTIC SUAL-IN-LINE PACKAGE OUTLINE 


QQQQQI QO 






PEELS 















(San ame a 


ALTERNATE SIDE VIEW 






Prenage contiquration ef '6-ein % 
gaaxage (100 siternative wdewews) 
igat tre eonen of Tt. 


NOTES: 0 faen orn concer {ine is lcaaces weeme 0.910 of ics crus ionqreudinel cemtion. 
B. All dimennens are in :nqnes untess otnernwes cctes. 


me 
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by. Ted Mahler Applications Engineer 


A GUIDE TO USING THE TEXAS INSTRUMENTS SN76439A SOUND - GENERATOR 


INTRODUCT ION - 


The TEXAS INSTRUMENTS §N76489A sound generator is designed to provide 
a low cost means of adding sound generation capabilities to 4 
microprocessor system. These sounds can include sound effects for video 


games, alarms for home or industrial use, or any application requiring 
audio feedback. 


Internally, the SN76439A contains 3 programmable tone generators, each 
with its own programmable attenuator, and a noise source with its own 
attenuator. By using tone generators oF combinations of tone generators 
and noise, an extremely wide variety of sounds can be easly created. 


A complete description of the functions available in the SN764389A 
along with electrical characteristics is presented in the 
TEXAS INSTRUMENTS data sheet for this device. This application report 
contains examples of the methods needed to generate control bytes for 
the SN764389A, along with interfacing data and examples. 


TEXAS INSTRUMENTS also manufactures the SN76489 which is pin 
compatable with the SN764389A with one exception. Audio out on the 
SN76489. is 100ma, which is capable of driving a small capacitively 
coupled speaker. The SN76489A has a 10ma output which will not drive 
a speaker but should be capacitively coupled into an amplifer. 


Software generation for both devices is identical. 


A 


Texas INSTRUMENTS 


INCORPORATE 
Post OFMCE BOR 1012 + Qauas. TEXAS 75222 
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$N76489A / $N76494 SCHELOGIC 


The SCHELOGIC of the SN76489A illustrates both its logic 
arrangement and the actual components on each on the pins 
of this device. This information is presented to aid in 


understanding and interfacing the SN76489A. 











EXAMPLE 1 
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Te 


The first example will demonstrate how to produce 4 4L67HZ tone 
with a clock of 2 MHZ. ; ee 


A) First, with this equation find n. This number (n) will contain 
the frequency information for the SN7 648 9A. 


elock/(32(tone) ) 
2 MHz /(32(4167HZ)) 
15 


or 

ll 

2 
feoun 


B) This number (n) is now converted to a 10 bit binary number. 


Frequency bit# FO-Fl F2 F3 Fa FS F6 F7 F8 F9 
ESO OO ee oh ee Wa 


C) Now construct the 2.bytes neccessary to transfer this 
information to the SN76489A. | 


a) The format for for frequency generation is: 


BYTE | BYTE 2 
* + 
B BB BB B B B B BBB B B B B 
itr et ti t t bt ft I 
2 FT) ET St | a: Ses Se ee: es eee ae | 
ae ae a ee ee eed 0123 4 5 6 7 
1 RO RI R2 F6 F7 F8 F9 0 xX FO Fl F2 F3 Fa F5 


* MOST SIGNIFICANT BIT (MSB) 
where RO, RI, and R2, in this case, tell the chip. which 
tone generator to use ( table 1 ). For tone generator 
1, RO = 0, RI = 0, and R2 = 0. 
FREQUENCY REGISTER CODE DEVICE 
RO Rl R2 


0 0 0 TONE | 


0 l 0 TONE 2 
l 0 0 TONE 3 


TABLE 1. FREQUENCY CONTROL CODES 


b) Therefore the 2 bytes will bes 
BYTE ! (000 £1 14 
BYTE 2 00000000 
Notice that although the last byte is zero, it does need 


to be included so that the SN76489A internal registor does 
not contain information from previous frequency bytes. 


EXAMPLE 2 t™*” | eae) 
This example will show how to program 4 hOOHZ tone on tone generatcr 
2 with a clock frequency of 4MHZ. 





A) First find n; 


= clock/(32(tone)) 
b) n= aMz /(32(400HZ) ) 
= 312.5 


Note that since n can only be an integer, you must change it: to 
be either 312 or 313. This decesion depends on the particular 
sound you are trying to obtain. For this example, 312 will be 
used. By substituting this number back into the equation you c3 
find the actual frequency that will be produced. 





a) n = clock/(32( tone) ) 

b) tone = clock/(32(n)) 

c) tone = 4MHZ/(32(312)) 
d) tone = 400.6HZ 


B) Now convert n to a 10 bit binary number. 


Frequency bit# FO Fl F2 F3 F4 F5 Fé F7 F8 F9 
01001 1 1 «80 0.60 


C) Using the frequency format; 


* * 

B BB BB B B B B BB BB 8B B B 
1 tt bette Pech Boe a de ak 
TP °F Fo TE tT ep Oe ea a 
o 123 4 5 6 7 Ou do as SE: A Oe 
1 RO RI R2 Fé F7 F8 F9 0 X FO Fl F2 F3 F4 F5 


* MSB 


the two bytes needed will be: . 





BYTE 1 10101000 
BYTE 2 60.00. 2000 8 


























EXAMPLE 4 ATTENUATION CONTROL an 


The third.major function available in the SN76489A is attenuation. 
Each of the three tone generators and the noise source has its own 
attenuator. The procedure for controlling each of these is the same. 


A) First select the device, within the SN76489A, which is to be 
attenuated. Each device and its associated code is 


ATTENUATION REGISTER CODE DEVICE 
RO RI R2 

0 o 1 TONE } 

o 1 1 TONE 2 

1 ot TONE 3 

tj. 4 NOISE 


B) Next select the desired level of attenuation as shown in this 
table. 


ATTENUATION ATTENUATION CODE ATTENUATION ATTENUATION CODE 


AO Al A2 A3 . AO Al A2 A3 
0 db 0000 16 db. b 6r Or 25 
2 db 000 1 18 db £. 6: o) 4 
4 db 001 0 20 db 101 0 
6 db oot l 3 22 db £0 i a 
8 db 0 10 0 24 db L 10 0 
10 db o 101 26 db ko oot 
12 db o 1 1 0 28 db inte, SP 28 
14 db @ tha OFF > 22 us 2 


C) Now construct the attenuation byte using this format: 


o4-o + 
H4ee 
NA-o 
we 
Fo4-D 
was 
an~-D 
Nede 


I RO RL R2 AO Al A2 A3 
* MSB 





EXAMPLE 3 NOISE ae 


White noise can easly be produced by selecting two options and 
using them to construct a one byte control word for the SN76489A. 


A) The first option is the noise feedback control (FB). A FR bit o 
0 selects periodic noise which sounds like a low frequency tone 
White noise, which sounds Like a hiss, is generated by a FB bit 
of 1. 


B) The noise source in the SN76489A is a shift register with an 
exclusive OR feedback. The rate at which it shifts is dependent 
on the clock and two noise frequency (NF) bits which make up 
the second option. A description of the two bits is given in ch 
following table: 





BITS 

NFO NF1 
0 0 HIGHER PITCH ( LESS COARSE HISS ) 
: fa 4 
1 0 LOWER PITCH ( MORE COARSE ) 


C) The options are now placed in the proper format for a noise 
control byte. 





* 

B B B 8B 8B 8B B B 

I I I I I I I I 

e Popo op EOS or 

0 l 2 3 4 35 6 7 

l RO RI R2 X FB NFO NFI 
* MSB 





Bits 1, 2, and 3 tell the SN76489A that this is a noise byte 
and should be as follows, RO = 1, Rl = 1, and R2 = 0. 
Therefore a noise byte to select white noise with the less 
coarse hissing sound will be: 


tiir100i10a00a 


The rate at which the noise clock shifts can also be 
controlled by the frequency of tone generator 3. To 
transfer control to tone 3 set both the NFO and NFl 
bits to 1. Now vary the noise generator, either 
periodic or white, by changing the ftrequecy of tone 
generator 3. 














INTERFACING ae 


The SN764389A is interfaced through 3 control lines and 8 data 
Lines. For the following definitions a high logic level is a 
minimum of 2 volts and a low is a maximum of .8 volts. 


CHIP ENABLE (CE) When low, this pin enables the SN76489A and ¢roo: 
the READY line to a low state. This pin must 
remain low until the completion of the data 
transfer. In most applications the CE pin is 
connected to address decoding logic. 


WRITE ENABLE (WE) When active, low, this pin signals the SN76439A 
that data is available on the data bus. As with ¢ 
this pin must remain low during the data transfe: 

‘ A memory write line is typically connected here. 


READY When the SN764389A is ready to accept data this Pp 
will be high. It will drop to a low level when C: 
goes low. From the falling edge of WE, the |. 
READY line will remain low for 32 clock cycles. 


DATA LINES (D0-D7) These pins accept data for the SN76489A. Since ¢t 
SN76489A requires 32 clock eycles for a data 
transfer, data must be available on these pins 
for that period of time. 


INTERFACING EXAMPLES 


CIRCUIT 1. TMS990/100M COMPUTER TO SN76489A INTERFACE 


This interface illustrates the use of the READY line to 
synchronize the SN76489A and the T™S990/100M. With this 
circuit the CPU will halt, allowing the slower SN764394 
to accept the data without necessitating any sort of 
software timing loops. Note that not all processors will 
function using this type of interface. A processor must 
be able to complete the write cycle ( place data on the 
data bus and enable its WRITE ENABLE line ) after 

its READY line is disabled. If the processor's architect 
is not designed this way or if the processor is not 
capable of being halted, an interface such as circuit 2 
should be used. , 


Addressing used in CIRCUIT | will select the SN7 64894 
when writing to any address from E000 to EFFF. This 4K 
block of memory can be reduced by further decoding of -t2 
address lines if necessary. 


C-21 


Therefore to attenuate Tone generator 3 by 4db the byte would 


be: 
LrLi¢d0r0adatda 


An L$db attenuation of the noise source would be: 


Vr’ bt. 9.4 














CIRCUIT 2. 


C-22 
PARALLEL PCRT INTERFACE | 


By using the READY line to contro! the duration of the 
WRITE ENABLE and CHIP ENABLE pulse, the SN76489A is 
assured that these pulses will be in their proper state 
for the proper amount of time. Two points must be 


considered when using this interface: 


L. The data lines must maintain the data for 
the entire transfer period (32 clock cycles). 
This can be accomplished by latching the data 
lines. 


2. Software using this interface must contain timing 
loops to avoid transfering a data byte to the 
SN76439A before it has had time to load the previc 
one. If a machine language program is being used, 
the number of machine cycles in the instructions 
can be counted and used to construct a 32 cycle lo 
If a higher level language ig being used, generall 
timing loops for data transfers are not necessary. 
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PROGRAMMING ‘EXAMPLE — . . C-24 
CLOCK CHIME 


The clock chime sound can be generated by using two of the t<on 
enerators and their attenuators. Tone generator lL is set to a frequenc 
of 679HZ at O dB down, while tone 2 is set to a frequency of 694 HZ at 
24 dB down. While holding tone 2 steady, tone | attenuation in ramped u 
until completely off. A time delay is used to hold tone 1 for a perioc 
of time at each attenuation level. The two frequencies, being slightly 
different, beat to create the chime sound. The chime is repeated by 
ramping tone | attenuation again. 


The following is a list of bytes which when presented to the SN764894, 
with the suggested time intervals, will produce this sound. Al! 
frequencies were calculated using 4 IMHZ clock. 


HEX BYTE TO SN76439A TIME INTERVAL COMMENT S 

FROM LAST BYTE 
9F TURN OFF TONE | 
BF * TURN OFF TONE 2 
DF * TURN OFF TONE 3 
FF * TURN OFF NOISE 
84 * STE TONE | AT 679H= 
0A 
90 sad SET TONE | ATTENUATIC 
AT 0 dB DOW. 
Ad = SET TONE 2 AT 694HZ 
0A 
BB * SET TONE 2 ATTENUAT IC 
AT 24 dB DOW. 

91 * TONE 1 ATTENUATED 2¢5 
92 114 ms ie " udE 
93 Ot] " " i] 6dE 
94 1" Ci] " tt Zdt 
95 i oT " LOdE 
96 " " " " 12dE 
97 ft " " " L4adE 
oF TONE | OFF 
BF " TONE 2 OFF 


* This period of time does not affect the chime sound. It should o¢ 
long enough to allow a data transfer from the controlling systom 
to the SN76489A. 
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Notice that 4 complete frequency sweep of. tone three is done 5Y 
incrementing the first byte of the two byte frequency word from CO to: CF 
while keeping the second byte at 00. After the last iteration of the firs’ 
byte ( CF); the second byte is incremented by 1. Now the process repeats 
incrementing byte 1 from CO to CF but this time holding byte 2 at Ol. This 
process continues until byte 2 is at OE. The noise attenuation can also 
be ramped down, during this sweep, from OdB down to off ( hex bytes FO 
to FF ). For the attenuation to reach maximum attenuation at the end of 
the sweep, it should be updated every other cycle of byte i. 


g the same basic program. For this 
is run from a low frequency to @ high 
with the time interval between tre 


A jet sound can be produced usin 
sound the frequency sweep of tone 3 
frequency then back to low frequency 
frequency words increased. 





EXPLOS IONS: 
Explosions are generated by setting the noise generator to white 


noise and ramping the noise attenuator from 0dB down ( Fo ) to off 
( FF ). Different time periods can be used between each attenuation 


update to simulate different types of explosions. 








MISSILE C-27 





The sound of a missile or jet can be produced using the noise 
generator and tone generator number 3. Generation of the sound is done 
by clocking the noise generator from tone generator 3 and then sweeol 
the frequency of tone 3 from a high frequency to a low frequency. Du 
the sweep, the noise generator is attenuated to give the effect of 
distance to the sound. “ 





HEX BYTE TO SN76489A TIME INTERVAL COMMENTS 
FROM LAST BYTE 











oF * TURN OFF TONE | 

BF + " t 2 

DF * " w "3 

FF * " " NOTSE 

E7 * CONTROL NOISE BY TONE 3 
FO * TURN ON NOISE = © 

Se * TONE 3 FREQUENCY ( HIGH } 
cl 18 ms TONE 3 FREQUENCY UPDATE . 
00 145 us 

C2 18 ms TONE 3 FREQUENCY UPDATE 
00 145 us 

Cs 13 ms TONE 3 FREQUENCY UPDATE 
00 165 us 

CF 138 ms TONE 3 FREQUENCY UPDA™ 
00 145 us 

Fl 13 ms NOISE ATTENUATION UPDATE 
co 13 ms TONE 3 FREQUENCY UPDATE 
Ol 145 us 

Cl 13 ms TONE 3 FREQUENCY UPDATE 
Ol 145 us 

C2 13 ms TONE 3 FREQUENCY UPDATE 
01 145 us 

CF 18 ms LAST TONE 3 UPDATE WORD 
0E 145 us ; 
FF HIGHEST ATTENUATION LEVEL 


* This period of time does not affect the sound. It should be long 
enough to allow the data transfer from the controlling system to 
the SN76439A. 














BASIC Language program listings C-28 


To aid in sound development 4 higher level language can be used to 
control the SN76439A. Listings given here were used on a system where ¢ 


. 


sound chip was interfaced using 4 parallel port interface. The SN76489A 
will then appear as 4 memory Location which can be written to using a F 
command ( on some systems this is a POKE command ). These programs, of 
course, will not be compatable with every system, but they should prese 


the basic method used to generate some given. sounds. 


10 REM ** BELL CR CHIME ** 

20 REM SYSTEM CLOCK FREQUENCY OF 2 MHZ 
30 N=59392 : REM LOCATION OF SN7 6489A 
60 FILL N,159 : REM TURN OFF TONE | 

50 FILL N,191 REM TURN OFF TONE 2 

60 FILL N,223 : REM TURN OFF” TONE 3 

70 FILL N,255 : REM TURN OFF NOISE 

30 INPUT A$ : REM INPUT ANYTHING 

90 FILL N,140 : TONE | AT 679 HZ 

100 FILL N,5 
110 FILL N,170 : REM TONE 2 AT 694 HZ 

120 FILL N,5 

130 FOR B=0 TO Il : REM B=NUMBER OF BELLS 

140 FOR [2145 TO 159 : REM LOOP TO GENERATE ATTENUATION STEPS 
150 FILL N,I : FILL N,(1+32) : REM OUTPUT ATTENUATION TO 764389 
160 FOR D=0 TO 75 : NEXT D: REM DELAY LOOP 
170 NEXT | 


. Wd oe ae oe of 


NEXT B 
190 PRINT "END OF SOUND" 


10 REM ** BASIC BIRD SOUND ** 

20 REM SYSTEM CLOCK FREQUENCY OF 2 MHZ 
30 N=59392 : REM LOCATION OF SN76489A 
40 FILL N,159 REM TURN OFF TONE 1 

50 FILL N,191 
60 FILL N,223 
70 FILL N,255 
80 INPUT AS : S=0 : REM INPUT ANYTHING 

90 ZsINT(10 *(RND(O)) : REM RANDOM CHIRP LENGTH 

100 FILL N,144 : REM SET TONE ATTENUATION 

110 FOR 120 TO 15 : REM START CHIRP LOOP 

120 FILL N,(128+I) : REM STEP FREQUENCY FROM 3906 HZ TO 2016 HZ 
130 FILL N,1 

140 FOR D=0 TO Z: NEXT D : REM DELAY BY RANDOM AMOUNT 

150 NEXT I 

160 $2S+Z : REM COUNT TO STOP PROGRAM 

170 IF $)200 THEN 190 : REM BRANCH TO END 

180 GOTO 90 

190 FILL N,159 : REM TURN OFF TONE | 


— 
a 
: 
4 
4 
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REM ** MISSILE SCUND ** 


REM SYSTEM CLOCK FREQUENCY OF 2MHZ 
N259392 : REM LOCATION OF SN76489A 


FILL N,159 : REM TURN OFF TONE | 
FILL N,191 : REM TURN OFF TONE 2 
FILL N,223 : REM TURN OFF TONE 3 
FILL N,255 : REM TURN OFF NOISE 


INPUT A$ : REM INPUT ANYTHING 
FILL N,231 : REM CONTROL NOISE BY TONE 3 
FILL N,2¢0 : REM SET NOISE ATTENUATION 


110 FOR B20 TO 15 : REM LOOP TO GENERATE SECOND BYTE 


FOR Azl92 TO 207 : REM LOOP TO GENERATE FIRST BYTE 
FILL N,A : FILL N,B : REM OUTPUT BYTE TO 76489 
NEXT A 

FILL N,(240+B) : REM ATTENUATE NOLSE 


160 NEXT B 


200 


GOTO 40 


REM ** BOMB DROP AND EXPLOSION ** 
REM SYSTEM CLOCK FREQUENCY OF 2MHZ 
N259392 : REM LOCATION OF SN76489A 
FILL N,159 : REM TURN OFF TONE | 
FILL N,191 REM TURN OFF TONE 2 
FILL N,223 


i 
: 
4 
g 


DB 

FOR J25 TO 17 : REM LOOP TO GENERATE BYTE 2 FOR SWEEP 
FOR 12128 TO 143 : REM LOOP TO GENERATE BYTE | FOR SWEEP 
FILL N,I : FILL N,J : REM OUTPUT BYTE TO SN76489A 

FOR Dz0 TO 10 : NEXT D : REM DELAY LOOP 

NEXT I 

NEXT J 

FILL N,159 : REM TURN OFF TONE | 

FILL N,228 : REM SET NOISE TO HIGH PITCH WHITE NOISE 
FOR 12240 TO 255 : REM LOOP TO GENERATE ATTENUATION BYTES 
FILL N,f : REM OUTPUT BYTE TO SN76489A 

FOR D20 TO 75 : NEXT D : REM DELAY LOOP 


210 NEXT I 
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PLEASE NOTE: 


TEXAS INSTRUMENTS cannot assume responsibility for anv 
circuits or systems shown, or represent that they are 
free from patent infringement. 
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E.5 USER REFERENCE CARD 
The Apple Development System Menu 
1 —- LOAD FROB MEMORY FROM APPLE DISK 
2 — MOVE FROB MEMORY TO APPLE DISK 
3 -- MOVE FROM CARTRIDGE TO APPLE DISK 
4 — MOVE FROM CARTRIDGE TO FROB MEMORY 
5 -- DISPLAY FROB CONTROL PARAMETERS 
6 — SET FROB CONTROL PARAMETERS 


7 -- RESET AND RUN PROG IN FROB MEMORY 





8 — RESET AND RUN PROG IN COLECO ROM 
9 — EXIT 


Frob Interface Unit LED Indicators 


LED Interpretation 
1- RST Reset in progress. 
2- MEM Memory space is selected. 
3- HOLD ColecoVision bus is being held. 
‘4- 1/0 oe I/O space is selected. 
5- WP (Write Protect) This LED is illuminated when Bit 4 


of the Frob Control Register is 
set. This prevents writes to the 
Frob memory fram the Apple or 
ColecoVision. 





6- CART (Cartrige Select) This LED is illuminated when Bit 3 
of the Frob Control Register is 
set. This indicates that the 
ColecoVision ROM is accessible at 
locations 8000 - FFFF. 





Power ColecoVision power switch is qm. 


The Lazer Monitor List Commands 


<<adrs>> Displays the contents of memory 
location <<adrs>>. 
<<adrsl>>.<<adrs2>> Displays the contents of the 


memory locations in the range 
<<adrsl>> .. . <<adrs2>>. 











<<adrs>> 


<<adrs>oL 


<<adrs>>G 
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Lazer Monitor List Commands (continued) 


: <<data>> Sets sequential memory locations 
to the values specified by 
<<data>>. 


Disassembles and lists 28 
instructions at the specified 
address. 


Executes the Z-8@ subroutine = at 
the specified address. 


<<al>>.<<a2>>G Sets a breakpoint at address 


<<al>> < 


<<dest>> 


<<dest>> 


ss << Dn ODO WD B & 


<<al>> and begins execution at 
address <<a2>>. 

<<a2>>.<<a3>>G Sets two breakpoints at addresses 
<<al>> and <<a2>> then executes 
Z-8@ code beginning at address 
<<a3>>. 


Copys data fram cartridge slot to 
Frob RAM. 


<  <<al>>.<<a2>>M Moves data from address <<al>> 
through <<a2>> to <<dest>>. 
<<dest>> is always in the same 
memory space as <<al>> and <<a2>>. 

< <<al>>.<<a2>>MV Moves the data from the currently 
selected memory space (memory or 
VRAM) to the other memory space. 
Initiates DEBUG.FRB program. 
Selects I/O port addressing. 


Loads binary file fran disk to Frob 
memory. 


Halts Coleco, entering MONITOR mode. 
Selects normal memory addressing. 

Resets the ColecoVision. 

Quits LZRMON program, returning to CP/M. 
Saves Frob program memory to disk. 
Selects VRAM addressing. 


Exits to the main LZRYON menu. 


